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Sun Mar 26, 1989 
D . KALE I TA 



at 17:49 EST 



I finally have the results of the OS-9 Users Group 
Elections. Only 46 members sent in their ballot 
(out of almost 800 members), but that's enough to 
pick new officers. The results are: 

PRESIDENT: 

Kevin Darling 36 votes / Bert Schneider 10 votes 

VICE PRESIDENT: 

Bruce Isted - 30 votes / Greg Law - 16 votes 

SECRETARY: 

Hark: Griffith - 18 votes / Bill Turner - 28 votes 

TREASURER: 

George Dorner - 45 votes / <abstain> - 1 vote 

The next step is for the new President to announce 
who will be Editor, Librarian and Director-at- 
large during his tenure. I'll let everyone know 
who Kevin chooses as soon as he makes it official. 



It ' B been an experience 



<Dave Kaleita> 



Dave has served the UG long and well. 
Most will Join me in saying: Thanks Dave! 



From the Editor 



As usual, many many things are happening. The 
biggest news is the announcement of RAVE, and its 
release on May 15th. Although RAVE may never see 
implementation on the Personal System level, its ad- 
vent provides a standard for Applications program- 
mers to work to. Also, for the first time. OS-9 has a 
graphics extension. Although details are not con- 
tained in the MOTD overview, the ba.sic capabilities 
are outlined: clipboard, resource, and font manage- 
ment to name a few. RAVE is just one of several 
good news tvpe announcements that I expect this 
year... stay tuned! 

The other biggie is the election results. The vote 
count may seem small, but it's a lot bigger than last 
time, and may be the biggest turnout yet, 

OS-9 is alive and well, and so is our UG. despite 
the lack of a column from any of the current oITi- 
cers, I guess everyone is just overwhelmed right 



In order to reduce publishing costs, 1 have gone 
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Real'Ttme Audio'Vtdeo Environm&nt Jy 



Well 

mostly 



I.O Product Overview 

RAVE {Real-Time Audio/ 
Video En\ironment) is a multi- 
media dc\elopment tool and 
user interlace that greatly sim- 
plifies the design of realistic 
man /machine interfaces for 
real-time process control sys- 
tems. As an extension of the OS- 
9 real-time operating system. 
RAVE enables designers to com- 
bine high-quality audio and vid- 
eo, computer generated graphics 
and customizable menus in the 
same user interface. With F^VE. 
designers can quickly configure 
realistic user interlaces and con- 
trol panels using real-world 
sounds and images. Because the 
resulting user interface better 
represents the actual control en- 
vironment, it can be manipulat- 
ed and understood by non- 
technical users 

2,0 The Evolution o£ 
Man/Machine Graphic 
Interfaces 

Historically, the user interfac- 
es available for factory floor pro- 
cess control applications have 
been difficult to use. and in 
some cases, intimidating. These 
interlaces typically consisted of 
non- interactive di.splays or light 
boards. At best, they were based 
on black and white graphics 
drawm on a conventional CRT. In 
the early 1980's user interfaces 
such as OKS and VDI were de- 
veloped and popularized. Users 
could now hope to find at least 
color drawings representing ac- 
tual devices that the system con- 
trolled. Audio capabilities, if any. 
were pretty much limited to 
"beeps" and "buzzes" and other 
non -descriptive noises. To com- 
pound the problem, these 
emerging interfaces were de- 
signed for UNIX or IBM Personal 
Computer systems without any 
consideration for real-time soft- 
ware re(|uirements. Because 
these standards had not been in- 
tegrated with a real-time operat- 
ing system or kernel, factory 
floor systems were still largely 
limited to 1960's- style user in- 
terlaces 



Eurthermore. these interfaces 
were still hard to use and under- 
stand by non- technical users. 
Simply put, these standards 
were designed by programmers 
for use by programmers. And be- 
cause programmers have not al- 
ways had the time or resources 
to create artistic masterpieces, 
graphic images left much to be 
desired in the realm of visual 
understanding and recognition. 
All of this resulted in factory 
control systems that could not 
be easily understood, let alone 
actively manipulated by non- 
technical users. 

3.0 The RAVE User 
InterCace 

Recognizing this complete 
lack of an easy-to-use and 
easy-to-understand man/ 
machine interface for real-time 
process control systems. Micro- 
ware has developed FiAVt: (Real- 
Time Audio/Video Environment). 
RAVE was developed on the 
simple premise that non- 
technical users can intuitively 
understand real-world visual 
representation --or pictures- -far 
easier than basic drawn image. 
Now, with RAVE the tools for 
user interface development are a 
microphone and camera, rather 
than a mouse and keyboard. 
Not only does RAVE support 
high-resolution, real-world pic- 
tures, but it also offers full- 
motion video and CD-quality 
sound. These advanced features 
allow a process or model to be 
represented by its natural image 
and natural sounds, as opposed 
to a programmer's personal con- 
ception of how that item should 
be represented. 

RAVE consists o£ 
three packages: 

• The Graphic File Manager 

• Gi^phics Support Library 

• The Presentation Editor 



The Graphics File Man- 
Continued Page 4 
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RAINBOWFEST CHICAGO 1989 



by Kevin Darling 




my viewpoint is probably much 
ditTerent than usual. I hope other 
I people who attended will also up- 
load what they saw and thought 
of things. I will just ramble 
through; 

Marsha and I got in 
Thursday afternoon after driv- 
; ing 14 hours from North Caroli- 
na. Before bed, we went across 
the street to one of the biggest 
malls in the country. I mention 
this mall only because we and 
several others dropped into a 
new hologram store there... and 
one ot the dozens of pictures was 
the most amazing we'd ever seen. 
It was laying horizontally, and as 
you walked up to it. a full -sized 
lab microscope sprang into 3-D 
\icw, sticking out about a foot. 
Vou could even look into the 
greenish ghost -like lens and see 
a slide through it! Incredible 1 
think this hologram was S200. 
btw <grin>. 

Friday around noon, cnh 

ers started to show up: Kent 
Meyers. Tony DiStetano and 
Chris Kochon. f^ale Puckett 
(without Esther!), and Gary Rob- 
inson from Tandy Tt)wers with 
his wife Karen (at their first lest). 

The show was open from 7pm 
to 10pm Friday night, (iary. Kar- 
en, Marsha and 1 wandered 
through in traditional first-night 
tashion... you grab a copy of all 
the literature to look through lat- 
er in your room when you ha\-e 
time <grin>. Altho Lonnie said 
that attendance was slightly 
down from last year. I couldn't 
tell. There seemed to be more 
booths to me, and thousands of 
people around as always. At 
tests, most everyone keeps their 
eyes glancing at everyone else's 
name badges, hoping to spot 
someone you know only by name 
on a forum. You meet a lot of peo- 
ple that way. (Kent wears a jack- 
et \vith his name on the back. He 
meets even more friends with 
this trick!) The Chicago fest is al- 
ways easier to get around in 
than Princeton, as the room is a 
I little larger. 

Above the noise of people talk- 
ing, the major background 
sound is the music of MIDI 
synths playing from several 
booths. Plus the Rainbow public 
address, which everyone hates 



because it totally prevents con- 
versation when they blare out 
something about "Get your pic- 
ture taken with CoCo Cat!", or 
the like. Kvery year we all swear 
we're gonna sabotage the PA sys- 
tem... 

Many of the CoCos on display 
had been t)uilt into PC -clone 
cases. It's almost becoming hard 
to find a plain coco at a test. 
Most of the ca.sed ones were run- 
ning OS- 9. while most of the 
normal ones were running 
RSDOS adventure games. Some- 
day a smart person is going to 
bring out a simple-to-do CoCo 
case kit and make millions at 
one of these tests. I hope. 

Friday nights go by quick- 
ly, and a bunch of us ended up 
in Kent s room (where I keep my 
computer). Those who haven't 
seen tons of VEF pictures get to 
see them there, plus people 
bring in programs that they've 
been working on to get opinions 
and suggestions. We also hash 
out ideas every year in Kent's 
room for new hardware, etc. 
Mike Haaland had sent along a 
gfx editor he w.ts writing tor us 
to look .it this time, and it was 
pretty impressiw with its use ot 
pulldown too! menus. 



Saturday morning we ti 

nally had permission to use 
Frank Hogg's booth for the OS -9 
Users Ciroup (Frank couldn't 
come because of a back injury, 
but he decided to donate the 
booth to the UG - thanks. 
Frank!), and we opened it up 
about 1 lam. Over the weekend 
quite a few forum people stopped 
by to say hi; and we also gained 
about 30 new members. We had 
copies of Dibble's new OS-9/ 
68000 Insights book and the 
new MW OS-9 Catalog to look at 

The Catalog and also the 
MW Sourcebook are free 

for the asking just by calling MW 
in Des Moines. Dibble's book is 
about S40. al-so from Microware. 
All are recommended reading 
material. 

Paul Ward and his triend 
Mark Sheffield. aJong with Mar- 
sha and Dick White. helped man 
the booth. Paul donated a lot of 
his "Start OS-9" books to the 
booth, with proceeds going to 
the UG. Thanks. Paul! 

Saturday at noon was 

when my "seminar" was. I had 
originally intended to demo 
some of the forum programs 



! there. But I noticed that they 
I had assigned me one of the 

bigger rooms, and I remembered 

I from last year that no one could j 

see a monitor that far away (they > 

! REALLY need to give us some j 
I big screen monitors or several 

tied thru an amplifier!). Plus > 

I most seminars put people to ! 

sleep when things start getting ; 
I over their head. Thus I decided 

I to try something radically differ- i 

ent at the last moment (these I 

there will attest to that :-).So I , 
i opened it up as a bull .session. 

I and the topi(^s ranged all over ! 

the spectrum. Some of it was | 

really enlightening to us. People [ 

apparently had a lot of opinions, j 
i and have wanted to speak out 

tor a long time i 



Questions and answers 
covered: What a (^oco-4 should 
be (dual proccssorf)«09/ 68000): 
Would they move to OSK? (not 
unless they could run their OS-9 
software with another cpu or 
emulator): What so tt ware do 
pet)plc want'.^ Uiieaper and easi- 
er word prtjcessors. spread- 
sheets, business sottware, edu- 
cational soltware. more business 
sottware. all under OS-9); Is eve- 
ry(Hie addicted to the CLEAR 
ke\V (positively!): Will there be a 
C upgrade package? (probably 
tiot. tho this (juestion is the one 
ol the most common at tests); Is 



! 



512K enough? (yes. for now any- 
way); Why doesn't Tandy pro- 
mote the CoCo more? (up to 
marketing, and besides which, 
lets face it. there are other 
things they make more money 
on, so let's just use what we 
have and educate users where 
we can). What kind of problems 
do you have? (the IRQ wire hack 
would solve most of these): and 
gosh i wish we'd taken notes on 
everything! Among the people 
there who helped out (much 
thanks!) were Paul Ward. James 
Jones of MW. Gary Robinson of 
Tandy. Bob Santy of PC DOS/ 
RSDOS xfr util fame. Kent Mey- 
ers, and Kevin Pease (who 
showed prototypes of his new 
68070 /hires-gfx OS-9 board 
set). We truly had most of the 
OS-9 know-how in that one 
room! As always. 1 talked about 
the need to join a club or get on- 
line tor help. Last year at Dale's 
seminar I asked who was on a 
forum or BBS. Out of two hun- 
dred people, only 6 were. This 
year almost everyone wast Re- 
markable difference. Plus virtu- 
ally everyone knew of and vised 
SheII+ and GSheIl + . It seems 
quite a bit of the software up- 
loaded to CIS makes its way 
across country in almost no 
time. 

We had an hour allotted for 
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the seminar, but 
they ended 
up havint^ 
to kick 
the whole 
place out 
alter two 
hours (!) 
because the next seminar was 
due to start. Apparently, that 
was some kind of record. Heck. 
we were just having a great time, 
is all. People had a lot to say. It 
could ve gone on all day long, 1 
suspect. Anyway, back to the UG 
booth lor several hours. After the 
test closed, we caught the last 
ten minutes of Gary Robinson's 
seminar on submitting software 
to Tandy. I wish I knew who that 
was in the room with the tape re- 
corder... I'd like to get a tran- 
script of this one!I do remember 
one thing: someone asked why 
Tandy doesn't sell developer's 
paks "like Apple" and Atari etc 
do. 1 had to jump in and say 
something myself on that one... 
the devpaks from those guys sell 
for S350-$1000 and include stutT 
like tech into, schematics, and 
OS calls. "Gee. we get the OS 
calls in our b-Il manual, and 
schematics for any Tandy hard- 
ware are easily available to any- 
one for dirt cheap", is what I 
said. The attendees were hugely 
pleased that at last Tandy had 
sent a rep to the Chicago test... 
and they made a point of saving 
how much they appreciated Gary 
showing up. 



Saturday t&ight,a bunch 

of us got together for dinner (and 
later of course ended up in 
Kent's room for more talk. I'm al- 
ways in\'ited to the Falsoft party, 
but somehow ne\er have gone to 
it over the years: instead I like to 
get together with the forum folk). 
There were a dozen of us. and 
we told the waitress that Dale 
Puckett was our "Dad". To our 
delight, she treated him just so, 
all the rest of the evening 
<hehe>... even tho half our 
group had grey hair and was ob- 
viously older than he was. It 
that's possible <grin>, 

-O- 

On Sunday I tlnally found 
time to get away from the booth 
for a tew minutes. Mike Knud- 
sen's IJltiMuse Mini software 
under OS-9 was very impres- 
sive. Bvcrv^hing is menu-driven, 
using the mouse, altho he also 
provides keyboard shortcut 
keys. The surprise of the show 
(to me) was Chris Burkes 256K 
ram upgrade,,, it can also be up- 
graded to 512K,,, but provides a 
way to start out cheaper. About 
S90. Owlware had "Window- 
Writer", a mouse-driven text- 
screen word processor,., several 
people (including Kent) bought a 
copy, so hopefully we'll have 
some reviews soon. It has tw^o 
cursor blocks ,,, mouse and text, 
with cut /paste and a kind of 
clipboard. 



Just before the lest shut 
down at 8pm Sunday, they took 
the usual Rainbowtest group pic- 
ture. In honor of Gary Robinson 
])eing at his first fest. I joined 
him towards the tront of the 
group... so you might actually 
get to see what some of us look 
like finally. 

That's about it. By 4pm the 
place was deserted. We left Mon- 
day at noon. Over the weekend. I 
had sold about Ifi copies of my 
book, which was enough for 
Marsha and 1 to make it back to 
North C^arolina again (whew!). 

-O- 

['YiencJs we saw there includ- 
ed Simmy Turner. Rod Motto. 
Dave Hansen. Roger Krupsky. 
Larry Olson. Mike Knudsen. Eric 
Oi{ blow. Tim Wilhite.Doug Dal- 
lon. Scott Ciriepentrog. Chris 
LUirke. Dick White. Paul Ward. 
James Jones. Steve Blasingame. 
Dave Philipsen. Marty Goodman. 
Kevin Pease, (ieorge Dorner. Lar- 
ry;* Strong. Rick Adams. Ron 
and Tracy Lammardo. Mark (jrif- 
fith. Bob Puppo. and Bruce Isted 
couldn't make it... and we 
missed them! 

Some of the show specials 
that I remember included moni- 
tor stands for SI. CoCo-3's for 
SI 00. Orch-90 lor S20. Multi- 
Vue for S25. L-II lor S59. Also 
one -but ton mice were SIO. two- 
button S39. Magnavox monitors 
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for S250. ST251 40-meg bare 
drives for S299. complete 5-meg 
(no case) HD systems for about 
SI 25. and lots of deals on fioppy 
drives of all types. 



UST OF COMPANIES 
AT THE FEST 



Alpha Software - OS-9 utili- 
ties 

AZ Small Computers - hard disk 
Burke&Burke - OS-9 utile, hard 
disks, RAH upgrades 
Cer-Comp - rsdos utile, pe- 
ripherals 

CBUG - floppy disks and acces- 
sories 

CoCo Connection - rsdoD utils 
Computer Plus - Tandy hardware 
Delphi - network 
DISTO/CRC - peripherals 
Gamepoint - rsdos games, Ras- 
can video digitizer 
Gimmesoft - games 
Glenside CC club - buttons, t- 
ehirts 

Howard Medical - monitors, 
hard disks 

Microcom - rsdos /OS-9 utils, 
peripherals 

Oblique Triad - adventure 
games 

Owl-Ware - hard drives, Win- 
dow Writer/OS-9 
Orion Tech - telecom soft/ 
hardware 

Radio Shack - Tandy soft/ 
hardware 

Rulaford Research - Lyra, MIDI 
synths 

Second City - OS-S/rsdos soft- 
ware, UltiMuse MIDI 
SpectroSystems - ADOS 
SRB Software - games 
StG Computers - OS-9 utils , 
bbs , printer dumps 
Sugar Software - OS-9 callig- 
rapher, educational software 
Sundog Systems - games 
Zebra Systems - peripherals , 




tklltors \'otc: Since Keufn menrioned the ^fW Sourcehook & Catalog . I thought I'd in- 
clude some pics... and the MW addresses, nou.' you haoe no excuse! (grfn). 



Micro^varc Systems Corporation 



Corporate Headquarters 

1900 N. W. 114th Street 

Des Moines, Iowa 50322 

Pbone: SIS/224-1929 

Fax: SIS/224-1352 



Western Regional OfSice 

4401 Great American Parkway 

Santa Clara, CallComla 95054 

Phone: 4OS/98O-0201 

Fax: 408/9S0-1671 



Micro^Mrare Japan Ltd. 

41-19 Honcho 4-Chome 

Funabashi City 

Chlba 273i Japan 

Phone: 0474(22)1747 
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ior real-time lartory lloor appli- 
cations. 



■ i«u«*aV<d»o Envimnmrnnt 



ager 

(GFM) provi(ies 
the aiuiio. video and input driv- 
ers needed to support the run- 
time user interfa(^e. The input 
divers support a keyboard, as 
well as pointing devices. The key- 
Ixiard driver supports any key- 
board, trom an IBM PC compati- 
ble keyboard, to a custom 
keyboard designed specifically 
for an application. The pointing 
device may he a mouse, touch 
pad. touch screen, or any device 
that returns X:Y coordinate in- 
formation. 

The GrapUcs Support 
Library (GSL) builds upon the 
GFM to create the more complex 
concepts required for an applica- 
tion. These include controls, in- 
dicators, and menus. Controls 
are objects on the display that 
mimic the behavior of switches. 
Indicators are objects on the dis- 
play that mimic the behavior of 
output devices. Both controls 
and indicators may be imple- 
mented as computer generated 
objects, or by digitizing an actual 
image of the device. 

RAVE'S third package, 
known as the Presentation 

Editor, draws upon the GSL 
and GFM to provide an interac- 
tive, menu -driven development 
environment for building applica- 
tions. With the Presentation Edi- 
tor, designers create the con- 
trols, indicators, and menus 
supported by the Graphics Sup- 
port Library. 

Designers interact with the 
Presentation Editor via a key- 
board and mouse. Audio can be 
input directly through a micro- 
phone, or loaded from disk. Vid* 
eo can either be captured via a 
camera, or built from scratch us- 
ing graphics primitives. A Paint- 
box can be used to modify either 
computer-generated or real- 
world video images. 

To use RAVE on new hard- 
ware, designers need only to port 
the low-level graphics, audio, 
and input drivers. 

And RAVE was imple- 
mented as an extension to 
Microware's OS-9 Real- 
time Operating system. 

RAVE provides users with corn- 
plete access to the real-time 
functionality ofOS-9. which is 
vital for many process control 
applications. Exceptionally fast ! 
interrupt response, preemptive j 
task switching and a ROMal>le 
modular architecture make OS-9 I 
the operating system of choice 



^^- 



4.0 OS-9: 
Advanced Real-Time 
Operating System. 

OS-9 has emerged as the pre- 
eminent real-time operating sys- 
tem for the Motorola 68000 
family of microprocessors. 
OS-9 incorporates a number 
of powerful programing features 

such as multitasking. 
"SHELL" user interface, utility 
programs. hierarchical file 
structure and record locking, a 
complete suite of resident devel- 
opment tools, networking and 
a host of high-level languages 
including a C Compiler with 
UNIX/BSD 4.2 extensions. The 
versatility of OS-9 in being both 
a real-time kernel and a real- 
time operating system has made 
OS-9 the leading choice for pro- 
cess control, data acquisition, 
communications and robotics 
systems world-wide. 

OS-9 includes a full -function 
real-time kernel and indepen- 
dent file managers to accommo- 
date virtually every class of I/O 
device, peripherals, networking 
and interprocess communica* 
tions. OS-9 takes a modu- 

lar approach to system config- 
uration to develop a complete 
computer system. These 

modules and associated file 
managers include the OS-9 ker- 
nel, math libraries. C libraries, 
the system security module, se- 
quential character file manager, 
random block file manager, se- 
quential block file manager, net- 
work file manager and the 
Berkeley socket file manager. 
Consequently, system integra- 
tors need only integrate the 
modules that are required for 
each application. This signifi- 
cantly decreases the memory 
size required for each system 
while increasing system perfor- 
mance. Also, the modular struc- 
ture of OS-9 allows any system 
to be easily expanded. 

Microware authors all of its 
compilers and interpreters. 
These include; C. Eortran. Pas- 
cal and Basic. These compilers 
are optimized for OS-9 and pro- 
duce compact, position indepen- 
dent, re-entrant. ROMable code 
required for advanced real-time 
applications. As an added bene- 
fit, users of OS-9 have the ability 
to edit, compile and debug di- 
rectly on the target system 
which significantly decreases the 
time necessary for .system inte- 
gration. Microware is a leader in 
C compiler technology for real- 
time environments. It's C com- 
piler architecture and libraries 
are modeled on the proposed 
ANSI C standard and conform 



to the Kernighan & Ritchie stan- 
dard. 

S.O The Grapliics File 
Manager 

The Graphics File Manager 
(GFM) brings together all the 
physical resources needed for 
the user interface. This includes 
a video driver, an audio driver, 
and drivers for the input de\ic- 
es. The diagram below shows the 
hierarchy supported by the 
CjFM. 

The Video Driver provides a 
very robust set of drawing and 
block copy functions. An appli- 
cation may draw lines, rectan- 
gles, polygons, circles, ellipsis, 
rectangles with rounded cor- 
ners, or text. With all drawing 
functions, the application may 
select several variations such as 
drawing with a pattern, using 
variable size pens, using dashed 
lines, or any combination of the 
above. 

All drawing is done on what is 
called a drawnmp. The applica- 
tion may create several draw- 
maps, and select any one to be 
displayed. The application may 
select a new draw map to be dis- 
played at any time. 

Simple and complex regions 
are also supported. These re- 
gions may be created and mixed 
very easily. Alter creating a re- 
gion, it may be drawn onto a 
drawTiiap. or used for clipping. 
In the later case, all drawing out- 
side the region will be clipped 
(not dravTO), 

A very powerful set of block 
copy and exchange functions are 
also supported This allows an 
application to copy or exchange 
images between drawmaps. Part 
of an image can be declared as 
transparent. This is done by us- 
ing a clipped region, or using a 
transparent color. 

The Audio Driver supports 
playback of pre-recorded audio. 
This audio data can be in memo- 
ry, or loaded off of disk. The 
quality of the audio is only limit- 
ed by the hardware. 

Two types of Input Drivers are 
supported: pointer and key- 
board. The pointing device may 
he a mouse, touch pad. touch 
screen or any hardware device 
that returns X:Y coordinate in- 
formation. Any type of keyboard 
may be supported using the 
GFM. The keyboard may be PC 
compatible or one developed spe- 
cifically for an application. 

The following is a list of func- 
tions supported by the GFM: 

Graphics Cursor Func- 



tions: 

gc col{) Set cursor color 
gc_hide() Hide cursor 
gc_org() Set cursor origin 
gc poe() Set cursor position 
gc_ptn{ ) Set cursor pattern 
gc_show( ) Show cursor 



Drawmap Control Func- 
tions: 



dm_close() close drawmap 

dni_copy( ) Drawmap copy 

dm_creat( ) Create drawmap and 

return ID 

dmcreateC) Create drawmap and 

return descriptor 

din_dup{ ) Duplicate drawmap and 

return ID 

djn_dupe() Duplicate drawmap 

and return descriptor 

dm_exch(} Drawmap exchange 

dm_irwr( ) Irregular write to 

drawmap 

djn_org( ) Set drawing origin 

dm_rdpix() Read single pixel 

from draiinmap 

dm read () Read from drawmap 

dm_tcopy{ ) Drawmap copy with 

transparency check 

dm_texch{ ) Drawmap exchange 

with transparency check 

dm_write( ) Write to drawmap 

dm_wrpix( ) Writes single pixel 

to drawmap 



Display Control Func- 
tions: 



dc_dBplei2() Return display 

size and resolution 

dcgetclat( ) Get a single 

CLUT value 

dc_getcluts( ) Get a range of 

CLUT value 

dc_relea( ) Release pending 

signal request 

dc_setclut() Set a single CLUT 

value 

dc_setcluts( ) Set a range of 

CLUT values 

dc_BBig( ) Send signal on 

video interrupt 



Region Functions: 



rg_creat() Create region 
rg_del() Delete region 
rg_diff() Create region from 
difference of two regions 
rg_isect() Create region from 
intersection of two regions 
rg move() Move region 
rg_unionn Create region from 
union of two regions 
rg xor( ) Create region from 
exclusive or of two regions 



Draining Parameter 
Functions: 



dp_afnt() Activate font 
dp_clip( ) Set clipping region 
dp dfnt( ) Deactivate font 
dpgfntn Get font 
dp_paln( ) Set pattern align- 
ment 

dp_pnsz() Set pen size 
dppstyl ( ) Set pen style 
dp ptn() Set drawing pattern 
dp_rfnt( ) Release font 
dp scmm( ) Set character code 
mapping method 
dp_scr( ) Set color register 
dp_tcoi() Set transparency 
color 



Video Inquiry 
Functions: 



vig_txtl( ) 
text 

viq_cpos( ) 
character 
viq icps() 
positions 
viq_fdta( ) 
viq gdta( ) 
viq_pntr( ) 
region 
viqrloc( ) 
location 
viq_rinfo( 



Calculate length of 

Return relative 

positions 
Return character 

for justified text 
Return font data 
Return glyph data 
Test if point is in 

Return region 

) Return region 
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descriptor infonnation 

viq dminfo( } Return drawmap 

descriptor information 

Graphics Drawing 
Functions: 

dr_bfil() Fill a bounded area 

with a pattern 

dr_carc() Draw a circular arc 

dr_circ() Draw a circle 

dr copy{ ) Drawmap copy with 

clipping 

dr_cwdg() Draw a circular 

wedge 

dr_dot{) Draw a dot 

dr drgn() Draw a region 

dr earc( ) Draw an elliptical 

arc 

dr elp6() Draw an ellipse 

dr erect () Draw an elliptical 

cornered rectangle 

dr _ewdg( )Draw an elliptical 

wedge 

dr_f f il( ) Flood fill an area 

dr jtxt( ) Output justified 

text 

dr_line() Draw a line 

dr_pgon( ) Draw a polygon 

dr plin( ) Draw a polyline 

dr_rect() Draw a rectangle 

dr text() Output graphics text 



Standard Character 
Output Functions: 

CO afnt() Activate font 
co_cod() Set character output 
drawmap 

CO dfnt() Deactivate font 
CO scmm( ) Set character code 
mapping method 
crt_cup( ) Cursor up 
crt_cdwn{ ) Cursor down 
crf_crght() Cursor right 
crf_clft() Cursor left 
erf home() Cursor home 
crt_cr() Carriage return 
crt_curyy( ) Cursor address 
(X:Y location) 
crt_dlin( ) Delete line 
crt_ilin( ) Insert line 
crtehwcur ( ) Show cursor 
crt_hidcur( 1 Hide cursor 
crt ceol() Clear to end-of- 
line 

crt ceos() clear to end-of- 
screen 

crt_revon( ) Start reverse video 
crt revof f ( )End reverse video 
crt ulon() Start underlining 
crt_uloff() End underlining 
crt_CBcrn( )Clear screen 
crt_ichar{ ) Insert character 
crt_dchar( J Delete character 
crt wrapon( ) Turn on auto-wrap 
mode 

crt wrapoff() Turn off auto- 
wrap mode 

Pointer Input Functions: 

pt coord( ) Return pointer coor- 
dinates 

pt_org( ) Set pointer orgin 
pt pos{) Set pointer position 
ptrein Release pending sig- 
nal request 

pt_aaig() Send signal on 
pointer change 

Keyboard Input 
Functions: 

kb rdy{ I Check for keyboard 

data ready 

kb_rel() Release pending 

signal request 

kb 3sig() Send signal on data 

ready 



Screen Management 
Functions: 

sn act() Activate screen 
sn_alink( ) Link action region 
to screen 

sn_close() Close screen 
sn_Gp() Call cursor process 
sn cpact() Activate cursor 
process for a screen 
Bn_cpdeact{) Deactivate cursor 
process for a screen 
Bn_deact( ) Deactivate screen 
sn dmlink() Link drawmap to a 
screen 

sn_getact() Return active 
screen 

sn info() Return screen infor- 
mation 
sn_ lower ( ) Lower screen m 



stack I 

6n_ open () open screen I 

sn_raise() Raise screen to top I 
of stack I 

Action Region 
Management Routines I 

ar_absxy( ) Return absolute co- j 
ordinates 

ar_act( ) Activate action re- 
gion , 
ar_close( iClose action region 
ar closesub( jClose sub-action 
regions 

ar deact() Deactivate action i 
region | 

ar find( ) Find action region 
containing coordinate ! 

ar grab() Start synchronous | 
grabbing \ 

ar info() Return action region j 
descriptor j 

ar lower() Lower action region j 
in stack ' 

ar ma6k( ) Mask incoming mes- 
sages for action region 
ar move() Move action region 
ar_open( ) Open action region 
ar raise ( ) Raise action region 
to top of stack 

ar redefine ( ) Redefine action 
region 

ar relxy() Return relative co- 
ordinates 

ar ungrab( ) Terminate synchro- 
nous grabbing 

Message Management I 
Functions: 

ms_fluEh() Flush message queue 
ms journ() Turn on/off 30urnal 



These includes controls, menus 
and indicators. 

Controls are objects on the 
display that mimic the behavior 
ot switches and slide- bars. The 
user may interact with a control 
on the display to turn something 
on or olT. A slide -bar could be 
used to mimic something like a 
volume control. 

Menus (called requests in the 
OSL) give designers a means of 
configuring an interface that en- 
ables users to select various con- 
trols and indicators. These me- 
nus may be simple text or 
complex images. The application 
may also select whether the 
menu is displayed all the time 
(menu bar), or only when appro- 
priate (pop-up menu). 

Indicators are objects on the 
display that mimic the behavior 
ot output de\iees. These inclvide 
a digital readout, level indicator. 
LEO meter, linear, meter, and a 




mechanism 

ms read( ) Read message queue 
ms ready( ) Check message queue 
ms release () Release message 
queue 

ms_signal ( ) Send a signal when 
a message is available 
ms stat() Return pointer stat- 
us 

ms unread { }Write a message to 
head of queue 

mG_ write { (Write message to end 
of queue 

Action Cursor Functions: 

ac act( ) Activate graphics 
cursor 

ac col{) Set graphics cursor 
color 

ac deact() Deactivate graphics 
cursor 

ac_org( ) Set graphics cursor 
and pointer origin 
ac po6( ) Set graphics cursor 
position 

ac ptn() Set graphics cursor 
pattern 

ac_track( ) Turn on/off automat- 
ic tracking of graphics cursor 

Sou n dmap Functions: 

sm close () close soundmap 
sm_creat{ ) Create a soundmap 
sm create () Create a soundmap 
sm_in( ) Input to a soundmap 
sm into() Return pointer to 
soundmap descriptor 
sm loop () Set soundmap loopback 
point 

sm off() Turn off soundmap 
option 

sm_ out ( ) Output a soundmap op- 
tion 
sm ready ( ) Check audio queue 



6.0 The Graphics 
Support Library 

The Graphics Support Library ' 
(GSL) builds upon the (iFM to ' 
create the more complex con- 
cepts needed by an application. 



strip chart recorder. These may 
be computer-generated objects ■ 
or actual images of a real device. | 

In addition to the on screen 
objects supported by the GSL. 
there arc many housekeeping 
functions supplied that make 
the task of writing an applica- 
tion a bit ea.sier. These include j 
message handling, a clip board j 
and resources. 



Following is a list of functions 
supported by the GSL; 

Resource Manager 
Functions: 

res copy () Copy a resource 
res count () Find resource type 
count 

res current () Get current re- 
source module 

res free() Tree resource mod- 
ule"' 

res_get() Get a sharable re- 
source 

res id() Find item 
res itype { ) Find resource type 
res load (} Load or link to a 
resource module 
res loadc()Load or link to a 
country-dependent resource 
module 

res set () Set current resource 
module 

res share () Determine if re- 
source is sharable 
res si2e() Get size of a re- 
source 

res tycount( } Find item count 
for a type 

Request Manager 
Functions: 

req activate ( ) Activate a 
modeless request 



req_create{) Create a request 
reqdeactivateC ) Deactivate a 
modeless request 
reqdef ( ) Execute standard 
definition function 
req_draw( ) Draw a request 
req_free() Free a request 
req_handler( ) Execute the re- 
quest ' 5 message handler 
req_hide( )Hide a request 
reqitemmark ( ) Change an 
item's checkmark 
req_itemst«te( ) Change an 
item's state 

req_make{) Make a modal re- 
quest 

req_move( ) Move a request 
req_BetcurB ( ) Place the point- 
er in a request item 
req_6how( ) Show a modeless 
request 

Control Manager 
Functions: 

cnt l_act ion () Execute applica- 
tion action 

cnt Inactivate { ) Activate a 
control 

cntl_bhv( ) Execute behavior 
function 

cntl create () Create a control 
cntl_deactivate( ) Deactivate a 
control 

cntl_def() Execute definition 
function 

cntl delete [) Delete a control 
cntl^dolist ( ) Perform a func- 
tion on a list of controls 
cntl draw () Draw a control 
cntl'_handler( ) Execute message 
handler 

cntl_hide( ) Hide a control 
cntl_max( ) Set the maximum val- 
ue of a control 
cntl_min() Set the minimum 
value of a control 
cntl_move() Move a control 
cntl_setcurs( ) Places the 
pointer on a control 
cntl_show( ) Show a control 
cntl_Btate ( ) Set the state of a 
control 

cntl value () Set the value of a 
control 

Indicator Manager 
Functions: 

ind_ create () Create an indi- 
cator 

ind_def{) Call an entry point 
in a definition function 
ind delete () Delete an indica- 
tor" 

ind_draw( ) Draw the entire in- 
dicator 

ind_ehow( ) Show an indicator 
ind hide () Hide an indicator 
ind_value() Set value of an 
indicator 



Clipboard Manager 
Functions: 

clip close() Close the clip- 
board 

clip_coQnt() Get clipboard 
type count 

clip_counter{ ) Get clipboard 
counter 

clip getptr() Get pointer to 
clipboard data 

clip_link() Link to the Clip- 
board 

clip_load() Load the clipboard 
clip owner { ) Get pointer to 
name of clipboard owner pro- 
gram 

clip_read( ) Read the clipboard 
clip_ready( ) Get data byte 
count 

clip_rewrite ( } Re-write in the 
clipboard 

clip_ropen() Open for read ac- 
cess 

clip_Bove() Save the clipboard 
clip_type(} Get clipboard type 
clip_unlink( ) Unlink from the 
clipboard 

clip wopen{ ) Open for write 
access 

clip write() Write in the 
clipboard 

Dispatch Manager 
Functions: 

hndir create ( ) Create message 
handler 

hndlr_delall( J Delete all han- 
dlers from an action region 
hndlr_delete ( ) Delete message 
handler 

hndlr_deptch{ ) Dispatch a mes- 
sage 
hndlr_prab( ) Set up message 
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I grabbing 

I hndlr ma6k() Change the ities- 

! sage mask for a handler 

Overlay Window Manager 
' Funetions: 



ovly close () Close an overlay 

vindov 

ovly open () Open an overlay 

window 

fnr dbox() Create dialog box 

frame 

frm oline() Create outline 

frame 

frm sbox() Create shadowed box 

frame 

dbox open( ) Create a dialog 

box overlay window 

obox open( ) Create a outlined 

box ovelay window 

sbox open() Create a shadowed 

box ovelay window 

VB^r Preference 
Functions: 

pref get() Get preference 

pref lin]c() Link to preference 

pref read ( ) Read preference 

from a file 

pref set () Set preferences 

pref write ( } Write preferences 

to a file 

IntemationaUzation 
Functions; 

intl currencyC ) Create a cur- 
rency string 

mtl date() Create a date 
string 

intl free() Unlink the inter- 
national data module 
intl ismetric( ) check for Met- 
ric/English measurement system 
intl set() Set the interna- 
tional data module 
intl time() Create a time 
string 

Association Table Functions: 
atbl create () Create an asso- 
ciation table 

atbl dealloc{) Deallocate an 
association table 
atbl delassoc() Delete an as- 
sociation 

atbl lookup ( ) Look up an asso- 
ciation 

atbl makeaaBOG(} Make an asso- 
ciation 

Fast Block-Move 
Functions: 

mv bytes () Fast move bytes 
mv wordB() Fast move words 



7.0 The Presentation 
Editor 

The P<AVE Presentation Editor 
is used to develop applications. i 
The Presentation Editor auto- 
matically generates C^ source | 
code lor all the soltwarc routines 
necessary to control the user in- 
terface. The designer is not re- ' 
quired to Write one line of A/V 
control code The entire interfa< e 
may he designed interactively by i 
using this tool. 

With the Presentation Editor. , 
a designer can create the con- 
trols, menus and indicators sup- ' 
ported by the GSL- These objects : 
may be combined onto the dis- , 
play to form the interface for an 
application. Since RAVE sup- 
ports real audio and real images ' 
in addition to those computer 
generated, the Presentation Edi- 
tor has tools for manipulating 
this data. 

The audio tools allow the de- i 



signer to capture, edit, and play- 
back audio segments. The video 
tools allow the same facilities for 
video images. In addition, a 
paint facility is available for 
creating new images or touching 
up images captured by camera 
or other means. 

8.0 Configturing RAVE 

RAVE is configured to provide 
both run -time and development 
environments. 

RUN-TIME 
ENVIRONMENT 

Ra\'es Graphic F'ile Manager 
(GFM) and (Graphics Support Li- 
brary (GSL) form the foundation 
of the OS-9/RAVE run- time en- 
vironment. This run- time envi- 



little as 128K of system RAM. 

The RAVE run-time environ- 
ment is configured for distribu- 
tion under Installation Pak and 
OEM License. These packages in- 
clude all of the software source 
code and documentation neces- 
sary to install the run-time envi- 
ronment on a given hardware 
platJorm. 

DEVELOPMENT 
SYSTEM 

The Presentation Editor and 
its related hardware (micro- 
phone, frame grabber, camera, 
paint box. video monitor, etc.) 
comprise the liAVE development 
en\ ironment- 

Microware understands that 
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ronment provides a sophisticat- 
ed man /machine interlace lor 
virtually any type of audio and 
video hardware; incduding 
mouse, touch .screen, terminal, 
microphone and speaker. r\ir- 
thermore. the GSL provides ba- 
sic indicators and controls so 
software engineers can build an 
application without the use ol 
more compk*x and expensive de- 
velopment tools. 

The entire RAVE run -time en- 
vironment is completely ROMa- 
ble. compact in size and de- 
signed expressly for use in 
embedded applications. An OS- 
9 /RAVE application can be em 
bedded in systems supporting as 



the ever increasing pace of tech- 
nological advancements make 
product design time a key factor 
of a product's commercial suc- 
cess. The time devoted to devel- 
oping a man /machine interface 
using conventional programing 
techni(]ues can render a product 
obsolete long before it is brought 
to market. The Presentation Edi- 
tor reduces the amount of time 
spent on developing the applica- 
tion by automatically generating, 
in C; source code, all the software 
routines necessary to control the 
user interlace. Simply put. by 
using the RA\^; development en- 
\'ironment. you can get your 
product to market quicker \vith 
less expense. 




The Users Group.... 



I 



The OS-9 Users Group is an ; 
international non-profit organi- \ 
zat^on of approximately 800 \ 
members (and growing) devoted I 
to exchanging and distributing ^ 
information about, and public 
domain software for, all available I 
versions of the OS-9 Operating | 
system. The OS-9 Users Group 
is the only independent group of- i 
ficially recognized by Microware 
(the developers of OS-9) as an : 
ofTicial voice of its users. 

The OS-9 Users Group peri- 
odically publishes this newslet- ' 
ter entitled "MOTD" which con- i 
tains many useful articles. ; 
software listings, and other in- ! 
formation helpful in keeping OS- ; 
9 computing enjoyable and re- 
warding. Other membership \ 
benefits include free technical ; 
help referrals (by mail or elec- 
tronic BBS) and significant dis- ' 
counts on the purchase of indi- ; 
vidvial volumes of the OS-9 j 
Users Group Public Domain 
Software Library. On^ year ' 
memberships in the group cost i 
S25.00 for individuals and S150 ^ 
for companies (corporate 
membership) and includes a i 
subscription \^o the MOTD nevvs- i 
letter, one free disk of public do- j 
main software (archive set of en- 
tire Library for corporate | 
members), and the right to pur- , 
chase additional disks of soft- 
ware at a very reasonable cost. 
The group's public domain soft- 
ware library currently has over 
56 individual volumes of soft- \ 
ware comprised of almost 300 ' 
individual programs. The library ; 
is constantly growing due to the 
groups policy of sending one vol- j 
ume (disk) from the library free ; 
for each individual program do- \ 
nated by a member, {note, al- 
though UG software is available | 
from other sources, only MEM- i 
BERS receive the latest, and li- | 
brarian maintained versions). 

To join the OS-9 Users ; 
Group, fill out the application ', 
form reproduced on page 9 (or i 
facsimile thereoO and send to 
the UG Tampa address. i 

After you join, you will receive \ 
a copy of the current issue of the , 
OS'9 Users Group newsletter ; 
("MOTD"), and soon after that, 
the "starter" diskette. UG Library i 
Volume #0. with software of the i 
type useful in getting you started ; 
with both OS9 and the Users 
Group. Current members who 
renew their membership will re- ' 
ceive a UG "donation credit" post 
card, which may be redeemed 
for most UG products and ser- \ 
vices at any time during your 
membership. 
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Product Overview: PCBridge 





PCBri<l£e is a low-cost, easy- 
to-use. PC-hosted development 
and supervisory system for intelli- 
gent 680x0 based applications. 



PCBridge can be linked to a 
variety of real-time tasks, and can provide a gateway for OS-9 data and 
applications on PC-DOS. A total distributed application can be devel- 
oped on the PC host and integrated into an OS-9 real-time en\'ironment 
using PCBridge. 

PCBHdge resides on the 
PC host system, with a spe- 
cial utility package resident 
on the OS-9 system. Using 
PC's. XT's or AT's as a front 
end. PCBridge links to the 
OS-9 target system \ia a seri- 
al line. Applications are devel- 
oped on the PC and then 
downloaded to the target for 
testing or execution. The OS- 
9 target system can be config- 
ured as a ROM-based system 
with limited RAM or as a com- 
plete professional develop- 
ment environment. 

The user interface ap- 
pears as a pop-up menu. 

This allows the user to select 
a function (edit, compile, 
transmit, etc. ), indicate the 
necessary parameters and 
PCBridge performs the opera- 
tion without further user in- 
tervention. PCBridge menu 
selections are made using key words, keypad cursor keys, or mouse. 



PCBHilge Environment 

PCBridge provides a platform that allows users to share C and As- 
sembler applications and data between PC-DOS and OS-9 through an 
RS-232 protocol link. PCBridge users have access to the OS-9 operating 
system allowing real-time process execution, data transfer, monitoring 
and debugging from a PC -host terminal. 

Microware's PCBridge is distribvited on IBM formatted 3 1/2" or 5 1 / 
2". diskettes. Also included is an OS-9 format diskette of OS-9 Utilities 
for in.stallation on the OS-9 target system. 

PC-Host Hardware and Software Requirements 

PCBridge operates on the following PC-DOS systems: 

- IBM PS/2 

- IBM PC/XT/AT 

- Any IBM PC/XT/AT Compatible System 

A minimum of 512 Kbyte RAM and 1 Mbyte of on-line disk storage is 
required for operation. The PC must be running PC-DOS Version 3.2 or 
greater and be equipped with an available serial port 



OS-9 Hardware and Software Requirements 

PCBridge operates on any O$-9/M0x0 system that sup- 
ports Version 2.0 (or later) of the operating system. 

Initial installation of PCBridge requires either Industrial OS-9. Per- 
sonal OS-9 or Professional OS-9 operating on the target system. All OS- 
9 resident modules of PCBridge consist Of standard OS-9 memory mod- 
ules and can be ROMed in any Industrial OS-9 system alter develop- 



ment and system reconfiguration. 



PCBridge XCC Cross C Compiler 

The PCBridge XCC Cross C Compiler is a fuU implementation j 
of Mieroware'S OS-9 C Compiler and contains all executable, li- 
brary and definition files contained in the OS-9 resident version. OS-9/ 
XCC was expressly designed for the 68000 family instruction set and in- 
cludes complete 68881 tloating point coprocessor support. The compiler 
performs multilevel optimization in order to produce extremely fast. 

compact object code. 
Compiled programs 
are completely ROMa- 
ble, reentrant and po- 
.sition independent. 

When trans- 
ferred from the PC - 
DOS host to the target 
OS-9 system. C object 
code can take full ad- 
vantage of OS-9's 
shareable memory 
modules which con- 
tain standard library 
I/O and mathematical 
routines. OS-9/XCC 
can automatically 
generate code which 
utilizes these sy.stem 
wide modules rather 
than linking redun- 
dant copies of the 
standard library to 
every executable pro- 
gram. By taking 
advantage of 08- 
9's unique modular environment in thU way, programs 
require less memory, less disk space, load faster and can 
be updated externally by a host system. 
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Each PCBridge package contains the following 
modules: 

OS-9yXCC C CompUer 

Assembler 

Unker 

User State Debugger 

OS-9/RS-232 Communications Package 

OS-9/Development UtiUties 

Memory Module Loader 
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Review: Basic09 XREF by Bill Brady 



Evefy onc« in a while 
you discover a sleeper. That 
is; a program that has been 
around for a while that you wish 
you'd had a long time ago. That 
happened for me with XREF. 

Now that Basica9 is sup- 
pUed with O8-9 Level a, 

more and more users arc discov- 
ering it's power. As you may 
know. Wiz and Wiz Professional 
terminal programs are written in 
Basic09. I believe that Window 
Writer is also done in B09. So 
commercial and shareware Ba- 
sic09 programs are coming to 
the fore. 

You may not know 
w^hat a Cross-ReEerenee 

program does, it's a fairly sim- 
ple thing, but you must know 
everything about the compiler to 
write one. and thoroughness is 
an absolute must. XREF eats 
BasicOy source files, and out- 
puts a listing.,, both of the 
source, and. at the end. a cross 
reference of every variable and 
line number contained within 
the program. 

The normal F3asirOO list tunc- 
tion puts a raw byte count in 
front of each line. But XF^FF as- 
signs simple, but understanda- 
ble line numbers, (not Basic09 
line numbers., just the number 
of that line in the listing). 

The manua l ' is a formatted 
printout on a dot matrix type 
printer. You normally don't get a 
manual at all with a utiliLV. It 
pro\ides instructions on how to 
set up the program, which al- 
though are not step by step, are 
more than adequate for an expe- 
rienced Basic09 programmer. 

Using XREF you can easily 
find out where any particular 
Basic line number is referenced. 
More importantly for me. howev- 
er, is that you can quickly spot 
unnecessary line numbers. 

What is an 'unused line #? 
Why is it necessary to spot 
them? Well, it depends on your 
programming style. In my case, 
when I am debugging code. I ol- 
ten stick in extra line numbers 
for diagnostic purposes. Later, 
when the code is fixed, that line 
number is no longer referred to 
elsewhere in the code. I really 
should go back and 'clean' up 
right away, but I am usually ofi 
in pursuit of the next bug in- 
stead. 

With XREF, I can go back lat- 
er and easily spot any of these 



left overs because they will ap- 
pear in the XREF with only one 
XREF line number opposite... 
the one in which they occur. 

in addition to Basic line 
numbers, XREF also does 

variables* Again, you can use 
the XREF to find 'toners' in this 
category. Great for reducing run 
time memory requirements. 

XREF comes in two ver- 
sions: with or without 

source. The BasicOg program 
'XREF' is a short front end' that 
calls XRMain and GetWord. and 
in either case is supplied in 
source form. Why? so you can 
customize... set your output 
path, and pathways to the ancib 
lary tile KE^'WOROS' (like /DI)/ 
SYS/KE^-WORDS. 

I gave XREF a quick try 

under OSK. and it loaded just 
fine. I don't see any reason why 
it wouldn't work with some mod- 
ifications, you'd want the full 
source >'crsion of course. 

XREFs Usting option U 
supplied as a separate pro- 
gram. It \ields a formatted list- 
ing without the cross-reference... 
you use this version for speedy 
pretty program listings only. 

Both programs are sup- 
plied in two versions, one 

for older printers which don t 
support the FF. (form feed or 
top-of-form). character I use an 
Epson with a sheet feeder, and 
performance was flawless for 
me. although I did have to set 
the printer for 12 cpi to keep it 
from line wrapping without the 
programs knowledge. 

XREF has been around a 
while, but then so has Basic09. 
and XREF is right in s\iic todav. 
1 am not sure of current pricing, 
but you can pick yourself up a 
copy of 68 Micro. 

Bacic09 XREF is a must 

have program for anyone seri- 
ous about Basic09. 1 know of no 
subsitutc for it. 



Basic09 Cross Reference 
UtiUty 
(XREF) 

Applied Computer 

Technology, Inc 
643S Summer Ave. 
Mempltis TN 3S134 

(901) 3T7-5503 



From the Editor - continued 



to a different layout for the 
MOTD. I am using different 
fonts: Bookman and CoOper 
Black. The point size is smaller, 
and there are now 4 columns, 
but there is also more 'white 
space'. The idea is to get more 
info in less space, and if the new 
printer is a good as I think he is. 
you will find this MOTD very 
readable, 

I have also purchased a better 
scanner: the AppleScan. It pro- 
\-ides 300 dpi output and does 4 
bit grayscale. I apologize for 
those who found the template in 
the last issue un- readable; I will 
re-scan with the new scanner if 
you like. (It was partly the print- 
ers iault). The AppleScan also 
works better with my OCR soft- 
ware This is how the RAVE. 
PC Bridge, and OS- 9 Signals seg- 
ments got in this issue. Let me 
know if you want more. 

Speaking of letting me 

knOW^, letters to the editor have 
dropped oil somewhat. Are you 
guys so happy uith the state of 
a Hairs that you no longer want to 
be heard? 

Although Kevin does not have 
an article here, he has asked me 
to stay on as Editor. 1 am not 
sure who the new librarian will 
be. nor correspondence secretary 
or Directors- at -Large. 

I'd like to say a Se'w 
words about reviews. We 

have received products that we 
have attempted to review but 
could not because they don't 
work, or don't work without 
modilication of OS-9. Rather 
than simply state that fact, w^e 
attempt to work with the produc- 



er to make that product useful. 
This usually works, but not al- 
ways. Keep in touch, because 
soon I'll need some reviewers. 
When you write, you must let me 
know all that you have, includ- 
ing software! 

Include your phone 

number on all 
correspondence! 

My HCA/WD system has 
been doivn* Not because of any 
defect in the basic product, but 
because the Western Digital con- 
troller board I used had a bad 
solder job. (& one chip improper- 
ly inserted. At this point, I can 
confirm that the HCA/WD and 
WDDisk version 5 driver works 
fine with Bob Santys PC DOS. 

You may have also noticed 
that the OS-9Boots section is 
missing. Have we covered all of 
the new OS-9 vendors? If you 
know of someone who is just get- 
ting into the OS-9 business, give 
me a holler. KEN -TON. in partic- 
ular has indicated that his Boots 
ad was very successful 

We need reviewers for 
OSK software* But you must 
have a fairly extensive hardware 
set. I need someone to review 
cross-compilers. 



We need some more 
User written articles. 



mmmmmmm>m>^ 



SUBMISSIONS 

Articles, letters and advertisements will be accepted in the following for- 
mats: 

VEF. (JIF. IVIACPAINT. MAC DRAW. CANVAS. TIFF. PICT. ThunderScan. 
MS WORD or WORI«. MACDRAFT. READY SET GO!, or Plain text files. 
ON AN^' OF THE fT)LLOWING: 5.25" ALL OS-Q FORMATS. 3.5" COCO- 
ATARI. 3.5" MAC 400K OR 800K. OR VIA E-MAIL TO THE EDITOR ON GE- 
NIE OR l^ELPHl. You can upload to my mainframe, if it is on line, between 
«am and 6pm EST lJser:Guest Password: CIVIL. 1200 baud. Call voice af- 
ter 6pm. The number is 301 952-1761. 

NO PAGEMAKER, Post ScHpt, or CIS midl please. 

Please include complete address, user #. and phone number on all sub- 
missions. Also tell me what you want us to do with whatever you are send- , 
ing. Article, Ad. or Letter to the Editor, etc. 

Include your phone number on all correspondence! 



0S9 USERS GROUP - SUITE R-2M - 1 715 EAST FOWLER AVE. -'lAMPA FL ^^3612 USA 
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OS-9 Users Group Software Library Order Form 

(For Members of the OS-9 Users Group ONLY) 
FROM... Member Number: i ) 



Name: 

Address: 

City, State, Zip: 
Telephone Number[s]: 



Computer Disk format TVpe (A. B, C or D - from iiistruetions); 

Format Code(s) of floppy disks vou can read ( 1 . 2. 3. 4, 5 and /or 6 - Irom 

instructions): 

[ Format? Price: 

Each** Total: 



guantity: Volume # ** Type: Code** 



Total amount for Individual Disks: 

** Note: Information indicated by a "**" above should be taken from 
the current UG Library Volumes listing, as reproduced in the UG 
newsletter. " 

Order Archive Set of Entire UG Library below (available as 
multiple set of disks in format code #6 ONLV): 





Format: Pri 


ce: 
Total: 




Volume #: 
Archive 


Type: 
A 
B 
C 


Code: ^ Each: 
6 $1(10 





Archive 


6 $iaio 

6 1 $130 

6 \ $ifb 

1 ■: 








Archive 


- 






Archive 1 D 












1 


+ Amount from above' 




1 










Total Payment enclosed: 





Please write us if you desperately need any of the above disks in any format 
other than the ones we currently offer (such as S" disks, other formats, 
etc.). We may be able to put yoirin touch with another volunteer UG mem- 
ber who could do the conversion for vou. 




Master Card # 
Visa Card # 
Signature: 



Make all checks payable to "OS-9 Users Group" 
Send disk order" to: OS-9 Users Group 

ATTN: DISK ORDER 

1715 East Fowler Ave.. Suite R237 
Tampa. FL 33612 

Please allow 6 weeks before inquiring about your order. 



Application for New or Renewal Membership in the 
OS-9 Users Group 

RENEWAL membership, your membership number please: | I 

IVpe ot membership applied for: | ] Corporate i ] Individual 



Name: 



(^-ompany Name (for (Corporate memberships only): 



Address: 



City. State. Zip: 
Country: 



Telephone Number(s): __^^ 

TVpe of Computer System you are running OS-9 on: 

Format of OS-9 floppy disks you can read (please check all that apply): 
5.25" { ] 8 " [ ] 3.5" [ ] Single-Stded [ ] Double-Sided [ 

Single-Density [ ] Double-Density [ ] Hi Density [ ] 

Number of tracks per side (35. 40, 80. etc.) [ 1 

FORMAT: Microware | ] CoCo [ ] Atari ST [ ] Mizar [ ] 

Other OS-9 Format (please describe): 



ELECTRONIC ADDRESS(S): CompuServe #: ( 
Delphi : [ ] GEnle: [ 

BIX : 1 ] UseNet : [ 



Would you be willing lo volunteer your time and effort to work on one of the OS-9 lit- 
ers tiruup's committees or run for an office? If so. please describe the capacity in 
whirh you wouki liite to get involved: 



( ) C'hecii here if you DO NOT want your name and address printed In a member di- 
rectory. 

1 j Check here if you DO NOT want your telephone number given out to other OS-9 
Users. 

Number of years membership you are enclosing payment for: [ ] 

INDIVIDUAL MEMBERSHIPS IN THE OS-9 USERS GROUP ARE S25.00 PER YEAR. \ 
(overseas S30 US I. CORPORATE (COMPANY') MEMBERSHIPS ARE ^150. (overseas I 
S160 US!. PER^'EAR I 

. ^ 1 

(sorry, but the Library archive set is presently only available on 5.25" ds dd 80 track ] 
or 3.5" ds OS-9/ST format disks) ' " j 

(The OS-9 Users Group Is a non-profit organization, any other charitable donations wlU 
also be gladly accepted.) 



Total Payment enclosed: $ [ 
Method of payment: [ 
Master Card # [ 



] 
] Check Number [ 
] Expiration Date ( / 




Make all checks payable to "OS-9 Users Group" 

Send application to: 
OS-9 Users Group 

ATTN: MEMBERSHIP 

1715 East Fowler Ave.. Suite R237 

Tampa. FL 33612 

Please allow 4 to 6 weeks before inquiring about your application. 



OS^ USERS GROUP - SUITE R-IM - 1715 EAST FOWLER AVE. - TAMPA FL 33612 USA 
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Instructions For Ordering U6 Library Disks 

PLEASE READ CAREFULLY BEFORIC SENDING IN YOUR DISK ORDER!! 



1 } Note what type of computer system you a 
all 0S--9 systems should be able to read on« 
diDks : 



running OS-9 on. Theoretically, 
0-: more of the following format 



OS-9 Users Group Software Library 
Volumes - 8/88 



Type "A": Standard Microware Format (track is single density 

and 10 sectors per track, all other tracks are 16 

sectors long; sector offset} 
Type "B": Tandy Color Computer Format (all tracks are double 

density and 18 sectors long; 1 sector offset) 
Type "C": Atari 3.5" Format (Micro-Floppy 3.5" disks, 8 tracks, 

all tracks double density and 16 sectors per track; 

sector offset) 
Type "D": OS-9 Users Group format (all tracks are double 

density and 16 sectors long; sector offset) 

This format is sometimes referred to as "Mizar format". | 

2 ) Determine what type of floppy disk drives you have on your OS-9 computer 
system. The available choices are... 



Type "a" 

Std. OS-9 Format: 
(5.25") 
35 track es sd 
35 track ds sd 
40 track 6s sd 
4 track ds sd 
4 track ds dd 
80 track ds dd 

Type "C" 
Atari OS-9 Format: 
(3.5") 
80 track ss dd 
80 track ss dd 
80 track es dd 
80 track ss dd 
80 track ss dd 
80 track ds dd 



Type "B" 

CoCo OS-9 Format: 
(5.25") 
35 track ss dd 
35 track ss dd 
35 track ss dd 
40 track ss dd 
40 track ds dd 
8 track ds dd 

Type "D" 
)S-9 UG / Mizar For 
(5,25") 
40 track ss dd 
4 track ss dd 
40 track 6s dd 
4 track ss dd 
4 track ds dd 
80 track ds dd 



KEY: SB=single sided, ds^double sided, 

sd=sinqle density, dd=double density 

For reference, it should be noted that some OS -15 UG media format codes 
equate to certain official Microware media format codes. In particular, the 
fol loving equivalences are noted: 

Media Format Codes 



icroware Systems 




OS 


~9 


Users 


Group 


5403 




-is equivalent to.. 






A5 




5803 




.IS equivalent to.. 






A6 




3807 




.IB equivalent to.. 






C6 




5407 




-is equivalent to.. 






D5 




5807 




.IS equivalent to.. 






D6 





Also note that the following Microware standard disk formats are 
also available by special request. Please do not order them 
unless it is the ONLY format you can use on your computer: 



Microware Systems 
3803 
3 8W7 
5 8W7 



..is equivalent to... 
..IS equivalent to. 
..is equivalent to. 



OS-9 Users Group 
C6a 
C6b 
D5b 



Choose the OS-9 Users Group format codes above which 
represent the formats of disks you know you are able to 
read. For example, most TRS-80 Color Computers can only 
read formats #Bl, ii|'B2 , #B3 and (sometimes) #B4 above. This 
indicates that a person with a stock Color Computer should 
be careful to only order Library volumes with these format 
codes. DO NOT ORDER LIBRARY DISKS WITH FORMAT CODES OTHER 
THAN THE ONES VmiCH YOU KNOW YOUR SYSTEM IS ABLE TO READ! 

3) Choose the Volume Numbers of the individual disks you 
would like to order, carefully noting the format code of 
each volume you would like to order. IF THE FORMAT CODE OF 
THE DISK YOU WOULD LIKE TO ORDER DOES NOT MATCH THE COPE 
OF A FORMAT YOUR COMPUTER SYSTEM IS ABLE TO READ (as 
calculated in step 2 above), YOU SHOULD NOT ORDER THAT 
VOLUMEli Yes, this means that it is possible that a disk 
you want may not be available ift a format you can read. 
This is sometimes necessary when an individual program on 
a disk 18 too big to fit on a small format disk. 

In particular, it should be noted that Volumes #2, and #49 
cannot be used on most TRS-80 Color Computers. Care should 
also be taken before ordering Volumes #6, #19, #39, #47, 
#55 and #56 (and any others whose format code is 4 or 
greater). Also note that the multi-disk "Archive Set" of 
the entire UG Library is only available on 80 track ds dd 
disks (format code 6) ONLY and can therefore not be used 
on a stock TRS-SO Color Computer. 

4) Prices for individual volumes are as follows (as of April 
1988) : 

Types "A","B" or "D" Type "C" 

(5.25") (3.5") 

1 $6.00 each S8.00 each 

2 $6.00 each S8.00 each 

3 $6.00 each S8.00 each 

4 $6.00 each SB. 00 each 

5 $6.00 each S8.00 each 

6 $10.00 each $10.00 each 



NOTE: PRICES ARE SUBJECT TO CHANGE WITHOUT NOTICE 1 Orders 
received 30 days or more after an official price change (as 
announced in the MOTD newsletter) are sub:iect to the new price 
schedule. Orders sent with insufficient payment will be returned 
unprocessed unless specific instructions to do otherwise are 
included with the order. 

5) Fill out the order blank reproduced in this issue (or facsimile thereof) 
with all of the necessary information. 



1 


01 


y 


2 


02 


y 


3 


01 


y 


4 


01 


y 


5 


00 


y 


6 


02 


y 


7 


02 


Y 


8 


00 


Y 


9 


00 


Y 


10 


00 


Y 


11 


00 


Y 


12 


00 


Y 


13 


00 


Y 


14 


03 


Y 


15 


01 


Y 


16 


00 


Y 


17 


00 


Y 


18 


00 


Y 


19 


.01 


Y 


20 


00 


Y 


21 


00 


Y 



24.01 
25. 02 
26.01 
27.01 
23.00 
29 . 00 
30.00 
31.00 
32.00 
33. 00 
34.00 
35.00 
3 6.00 
37.01 
38.00 
39.00 
40.00 
41.00 
42.00 
43.00 
44 . 01 
45.00 
46 . 00 
47.00 
48.01 
49. 00 
50.00 
51.00 
52.01 
53.00 
54.00 
55.00 
56.00 



(disk 
(disk 
(disk 



(disk 
(disk 
(disk 
(disk 
(disk 



#2) 
#2) 
#2) 



#3) 
#3) 
#2) 
#3) 



4 
5 

1* 

1* 

1* 

4 

3 

1 



,' Title: 
New Member Intro 

Spelling Checker (Improved; 6809 & 68K) 
Spelling Dictionary (102,681 words, 6809 d 
Word Processing Utils 
Programming Utilities 
File Processing Utils 
Adventure Game (source) 
Adventure Game (object) 

General Interest (demo, games, finance) 
C Programmer ' s Tool Kit 
Math & Electronics 
Word Processing Utils 
Programming Utilities 
File Processing Utils 
File Maintenance 
Communication 
Hardware Customizations 
Basic09 Programmer's Tool Kit 
System Utilities 
Languages 1: XLisp (source) 
XLisp (object) 
File maintenance 
Programming Utilities 
File Processing Utils 
General Interest 
Word Processing Utils 
C Language Math Library (6 809 only) 
<undef ined> 
68K Utilities 
File Maintenance 
File Processing Utils 
Hardware Customizations 
Hardware Customizations 
System Utilities 
Hardware Customizations 
System Utilities 
General Interest 

Communication (6809 & 68K Kermit) 
Programming Utilities 
Communication (Freeware) 
System Utilities 
Programming utilities 
Coco Graphics 
System Utilities 
Communication (SmodS) 
Coco Graphics 

Text Processing Utils (Sled) 
Text Processing Utils (68K Runoff) 
<undef ined> 

Text Processing Utils (HicroEMACS) 
6SK Utilities 
68K Utilities 
Math & Electronics 
68K Utilities 
File Maintenance 

Text Processing Utils {QED for L2 ) 
Data Base Management ( SDB for L2 ) 

l)All of the above volumes are available in Microware stanJard. Atari ST 3..^". , 

TRS-K> Color Computer and OS-^ LIG/Mizar formats. When ordering, be sure to specif\ ! 

orlv formats that vou K_NOW you can read on your computer! Please remember that some ; 

volumes of the Library will not fit on all formats of disk. If you do not specify the format you I 

desire, you will be shipped either OS-9 UG standard 5.25" format (i.e., "TYPE "D"). or the | 

format we have on file or \'ou (as specified by you on your membership/renewal appiica- j 

tion). Please note that 8" disks are no longer available directly from the UG. | 



2) Volumes which arc not merioncd above, or are marked with j 
N" in the "Done?" column, are NOT AVAILABLE at his time. Orders ; 



(disk 


#3) 




(disk 


#4) 




(disk 


#2) 




(disk 


#3} 




(disk 


#2) 




(disk 


#4) 




(disk 


#3) 




(disk 


#3) 




{disk 


#2) 




(disk 


#4) 




(disk 


#3) 




(disk 


#4} 




(disk 


#5) 




(disk 


#5) 




(disk 


#4) 




(disk 


#2} 




(disk 


#2) 




(disk 


#3) 




(disk 


#2) 




(disk 


#3) 




(disk 


#2) 




(disk 


#4) 




(disk 


#4) 




(disk 


#4) 





unavailable volumes will not be processed. 




.^) Send orders to the main UG address, making sure the en\e- ^ 

ope is clearlv marked "ATTN; DISK ORDERS". Orders marked an>- j 

thing other than "DISK ORDERS" \ 

mav be de!avcd an additional 4 to 6 ! 

weeks, do' NOT ADDRESS YOUR j 

ORDER (OR CORRESPON- j 

DENCE ABOUT YOUR ORDER) I 

TO "LIBRARY" OR "LlBRARl- - 

AN". 1 

4) The ENTIRE OS'<> UG 
Library is presently available in a spe- 
cial multiple set of 60 track (% tpi) 
double-sided dogble-detisity OS-9 for- , 
mat disks (UG format code "#6" j 
ONL^O- Pfcase note that this set con- i 
raitis all software that is presently con- 
tained in the UG Lpbrary EXCEPT he | 
spelling dictionary, which is ONLY j 
available on the ndividual Volume #2 j 
brary disk. 

OrderM wUl be mC' ! 
eeptea firoju HEM- | 
BERS ONIX 
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OS-9 Signals 



Signals are one of the 
Sour means of interprocess 
communications available 
in the OS-9 system. Signals 

are a single, sixteen-bit quantity 
primarily used as a synchroniz- 
ing or controlling mechanism be- 
tween two processes. They are 
not intended as a means of ex- 
changing data. Most frequently 
they are used in controlling the 
execution of multiple, asynchro- 
nous processes, or in coordinat- 
ing the use of some shared re- 
source. For example, this could 
be a device such as a printer, or 
a common data area in memory. 

All processes that re- 
ceive signals must provide 
a means Cor catching' each 

si gn a l * This method for catching 
signals is termed an intercept 
routine. If a signal is sent to a 
process not providing an inter- 
cept routine, the process will be 
aborted. The procedures for es- 
tablishing an intercept routine 
will be examined later. 



Signal Values and 
Reserved Signals 

OS-9 makes extensive use of 
signals for its own operation and 
provides several predefined sig- 
nals. These are signals with the 
values 0. ]. 2 and 3. These sig- 
nals have an unique status rela- 
tive to all other signal values and 
produce elTects somewhat difler- 
ent than other signals. These sig- 
nals have the following mean- 
ings: 

Signal O is defined as 
the unconditional kill stg- 

naL It is not interceptable. Any 
process receiving it will be termi- 
nated, regardless of whether or 
not an intercept routine is pro- 
vided. This signal is used pre- 
dominately from the console to 
terminate runaway processes, 
processes that are stuck in an 
infinite loop, impossible I/O 
tasks or other non-recoverable 
situations. Use of the Shell com- 
mand KILL will result in this sig- 
nal being sent to selected pro- 
cesses. Its use is not limited to 
the keyboard, as it can lilso be 
sent from within a user program. 



Signal 1 is deHned as 
the wake-up signal. Signals 
of this type are sent to processes 
which are sleeping (e.g. as a re- 
sult of executing the FSSleep 
system call). This is trequently 
done by drivers waiting for an 1/ 
O operation to be completed. In 
this case, an interrupt is gener- 
ated when the transfer occurs. 



Then the IRQ service routine will 
send a wake -up to the driver re- 
questing the operation. Another 
example is provided by the 
Events system. Events use the 
wake-up signal to indicate to 
waiting (sleeping) processes that 
an event has changed value and 
may have come into range. A 
process does not have to have an 
intercept routine to be sent a 
wake -up signal and function 
properly. The wake -up signal \v\\\ 
never kill a process, regardless of 
whether it pro\'ides an intercept 
routine or not. Sending a wake- 
up signal to an active process 
has no effect. 

Signals 2 and S are spe- 
cial keyboard signals generated 
by entering specified keystroke 
sequences. Signal 2 is the key 
board abort, and is usually gen- 
erated by a ControLK sequence. 
Signal 'i is the keyboard inter- 
rupt, and is sent in response to a 
Control-C sequence. These sig- 
nals can be used to produce sim- 
ilar effects, however thev are ac- 
tually quite different. 

Signal Z causes the re- 
ceiving process to termi- 
nate. Signal 3 may or may 
not cause the same process 

to terminate. If a process has 
performed I/O to the terminal 
from which signal 2 is sent, and 
the process is the last process to 
do so, the process will terminate. 
Otherwise, signal 2 causes the 
process to begin to operate con- 
currently, with respect to its 
Shell. This can sometimes be 
used to force processes into a 
background mode of operation. 

Signals 2 and 3 are sent to 
the last process which has per- 
formed I/O on the terminal from 
which the signal is sent. Keep 
this is mind in order to avoid in- 
advertently signalling to the 
wrong process. Both signal 2 and 
3 are interceptable. Because OS- 
9 utilities do not have intercept 
routines, the effects will be as 
described. User written pro- 
grams with intercept routines 
may use these signals to their 
advantage. Although not present- 
ly defined, signal values of 4 to 
255 are reserved for future sys- 
tem use. This leaves values in 
the range 256 - 65535 available 
for user purposes. 

A ^ven signal typically 
has only one destination. 

With a single exception, signals 
are sent between two processes. 
With the same exception, a sig- 
nal may not be sent to more than 
one destination at a time. A pro- 



cess may however signal to mul- 
tiple destinations, and a single 
process may receive signals from 
more than one process. The ex- 
ception to the above description 
is a signal sent to a process with 
a Process ID (PID). of zero. This 
will broadcast the signal to all 
waiting processes which have 
the same group /user ID num- 
ber. 

Using signals 

Sending a signal is relatively 
simple. The process ID of the re- 
ceiving process must be either 
knowTi or determined. If the sig- 
nalling process has used the 
FSP^ork system call to create the 
recei\ing process, the signalling 
process can store its own ID for 
later use. A process may deter- 
mine it's own ID by using the 
FSID call and exchange it with 
other processes via a mecha- 
nism such as a named pipe. 

Once the ID of the receiver is 

know^. the F$Send system 
call is used to actuality 
send the signal. This call is 

packaged into the C killO fvmc- 
tion. Whether called directly or 
as a C function, the appropriate 
error checking should be per- 
formed on return from the call. 
Since signals do not queue on 
the receiver's end. attempts to 
send a signal to a process with a 
pending, unprocessed signal will 
return the ESUSigP error. In this 
event, the signalling process 
should wait for a short period of 
time (i.e. sleep for a few ticks), 
then retry the signalling. At- 
tempts to signal to an invalid 
process ID will result in the 
ESIPrcID error. Care should be 
taken to always test for these er- 
rors when attempting to signal 
to another process. 



The receiving process 
uses the F$icpt call, via the 

interceptl) Junction In C. to catch 
the signal. The address of the 
signal handler routine to be per- 
formed when a signal occurs is 
part of the call. This routine 
must be as short and fast as 
possible. Tv-pically. the only ac- 
tion taken is to set a global vari- 
able to the value of the received 
signal, then returning. In partic- 
ular, calling other functions 
from within the intercept routine 
is very bad practice. If another 
signal is received while in the in- 
tercept function, it will be called 
recursively, using seventy bytes 
of user stack space to save the 
current configuration. 

Once the signal handler has 



intercepted the signal and re- | 
turned its value, the actual pro- ! 
cessing of the .signal occurs. For 
example, the C "switch" struc- 
ture might he used to select 
among several courses of action, 
based on the value of the signal 
received. The actual processing 
performed would be dependent 
upon the purpose of the pro- 
gram, hut in any case would not ; 
be performed inside the signal 
handler itself. j 

Editors notes: 

The above article is a brief 

white paper that I received with I 

some other Microware literature. 1 1 

have more oj these if you'd like to \ 

see them. \ 

I'd like to add two items to this j 

discussion. First signals can be j 

used with Basic09. In fact, they j 

are easier to use with Basic09 j 

than with C. You simply use the ] 

ON ERROR GOTO statement \ 
to set the trap, and check Jor the 
error number within your error 

handler. J^ter each signal a no th- \ 

er ON ERROR GOTO must be exe- \ 
cuted.. that's all there is to it. 

As for error 2 and 3 ^eing 

fatal to your BasicOQ program, 
you have two options: stop them 
Jrom occuring... or catch them. 
Since they come Jrom the key- 
board, you can stop them from oc- 
curing by redefining them to \ 
some character that the keyboard j 
cannot produce. You have two ' 
ways oJ doing this also. One: just j 
tmode the path: 

SHELL "tmode eof=255" 

Or you can read in the path 
descriptor, (using syscall), and 
modify it to suit your needs, then 
read it back to the system. The 
advantage oJ this method is that 
by saving a copy oJ the 'old' PD. 
you can restore it when your pro- 
gram exits. 

One more thing, notice the sys- 
tem overhead talked about in the 
paper. Note also that if two sig- 
nals occur in the time frame need- 
ed to process one. the second is 
lost. This is because signals are 
intended to be used to signify 
EVENTS, which are relatively 
rare occurances. Signals should 
NEVER be used as substitutes Jor 
interrupts, and you should 

not get into M situation 
^here there is a one-to- 
one correspondence be- 
tween interrupts and sig- 

nais» Take note oJ that you termi- 
nal program writers out there! 
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Advertise in the OS-9 Users Group Newsletter! The newsletter will be printed period- 
ically in either an 8.5" x 11 " (letter size) format, or a 1 1" x 14.5" (tabloid size) format. 
The ad cost is the same regardless of publishing format, with the exception that two 
color ads will only be available in the issues published in the Uirger format. Contact 
a UG officer before publication deadline for information about which lormat the next 
issue will be in. 

Send your camera-ready, or electronic ad copy and a check for payment to Lhc OS-9 
Users Group so that it is received no later than the 15th of the month prior to publi- 
cation month. 

Advertising rates are as follows (as of March . 1 989): 

Full Page: S200, Half Page: 8100, Quarter Page: S75, B:ight Page: S30 

See "submlssslons" for acceptable formats. 

Each member is entitled to place reasonable classified a<ls £ree. 



MOTD Is published monthly, or at 
other Intervals as required, by the OS9 
Users Group Suite R-237, 1715 East 
Fowler Ave. Tampa FL 33612, 

Editor: William L. Brady 

1503-1 Flanders Lane 

Harwood. MD 20776 

301-952-1761- 

Make checks payable to: 
"The OS9 Users Group". 



Distribution Is Free to members of the 
OS9 Users Group. Non-Members may 
subscribe by sending a letter ATTN Mem- 
bership, at the adress above, and by pay- 
ing a S25.00 annual fee. 

The OS9 Users Group is not affiliated 
with any other organization. 



: This issue of the MOTD was produced using 
I Ready Set Go! 4.5 on 2 meg Macintosh computers, a 

Mac II and a Plus. Mastering done on the Plus with a 

GCC Personal Laser Printer. Drawings produced in 
, CAm^AS 2.0. Scans via AppleScan. placed in PICT 
\form. Fonts are Bookman. Cooper Black. Courier, and 

Hclvitica. (6-32 points). Chief ass t helpers: Jane Lar- 

ivee aka: Mrs. Brady, and Larry Myers. 
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